3D Graphics Programming with QuickDraw 3D 1.5.4

Gestalt Selectors

You can use the QAEngineGestalt function to get information about a drawing engine. You pass QAEngineGestalt a selector that determines the kind of information about the engine you want to receive and a pointer to a buffer into which the information is to be copied. The selectors are defined by constants. Note that your application must allocate space for the buffer (pointed to by the response parameter) into which the information is copied.



 
typedef enum TQAGestaltSelector {

    kQAGestalt_OptionalFeatures         = 0,

    kQAGestalt_FastFeatures             = 1,

    kQAGestalt_VendorID                 = 2,

    kQAGestalt_EngineID                 = 3,

    kQAGestalt_Revision                 = 4,

    kQAGestalt_ASCIINameLength          = 5,

    kQAGestalt_ASCIIName                = 6,

    kQAGestalt_TextureMemory            = 7,

    kQAGestalt_FastTextureMemory        = 8,

    kQAGestalt_NumSelectors             = 9

} TQAGestaltSelector;

Constant descriptions

kQAGestalt_OptionalFeatures: QAEngineGestalt returns a value whose bits encode the optional features supported by the drawing engine. The response parameter must point to a buffer of type unsigned long . See "Gestalt Optional Features Response Masks" for a description of the meaning of the bits in the returned value.
kQAGestalt_FastFeatures: QAEngineGestalt returns a value whose bits encode the features supported by the drawing engine that are accelerated. The response parameter must point to a buffer of type unsigned long . See "Gestalt Fast Features Response Masks" for a description of the meaning of the bits in the returned value.
kQAGestalt_VendorID: QAEngineGestalt returns the vendor ID of the drawing engine. The response parameter must point to a buffer of type long . See "Vendor and Engine IDs" for a list of the currently defined vendor IDs.
kQAGestalt_EngineID: QAEngineGestalt returns the engine ID of the drawing engine. The response parameter must point to a buffer of type long . See "Vendor and Engine IDs" for a list of the currently defined engine IDs.
kQAGestalt_Revision: QAEngineGestalt returns the revision number of the drawing engine. (Larger numbers indicate more recent revisions.) The response parameter must point to a buffer of type long .
kQAGestalt_ASCIINameLength: QAEngineGestalt returns the number of characters in the ASCII name of the drawing engine. The response parameter must point to a buffer of type long .
kQAGestalt_ASCIIName: QAEngineGestalt returns the ASCII name of the drawing engine. The response parameter must point to a C string whose length you have determined by passing the kQAGestalt_ASCIINameLength selector to QAEngineGestalt .
kQAGestalt_TextureMemory: QAEngineGestalt returns the size, in bytes, of the memory available for storing texture maps. Note that the amount of memory required to hold a particular texture map depends on the texture flags of that texture map--in particular, on the texture compression and mipmapping flags. (See "Texture Flags Masks" for details.) As a result, the size returned by QAEngineGestalt is only a rough indication of the number of texture maps that can be created. The response parameter must point to a buffer of type Size .
kQAGestalt_FastTextureMemory: QAEngineGestalt returns the size, in bytes, of the fast memory available for storing texture maps. (Fast texture memory is memory located on a hardware accelerator.) Note that the amount of memory required to hold a particular texture map depends on the texture flags of that texture map--in particular, on the texture compression and mipmapping flags. (See "Texture Flags Masks" for details.) As a result, the size returned by QAEngineGestalt is only a rough indication of the number of texture maps that can be created. The response parameter must point to a buffer of type Size .
kQAGestalt_NumSelectors: The number of selectors currently defined.